Readme notes for E2920 Series PCI/PCI-X Exerciser/Analyser cards. Updated Nov 14th, 2003
--------------------------------------------------------------------------------

This is the README-file for the Agilent E2920-Series Linux-Suite.
It contains the CAPI for PCI and PCIX as shared libraries.

1. Installation:
----------------

Prerequisites:
- You must have root-privileges and root environment (search path) 
  for the installation (use "su -") !
- A linux system running kernel 2.4.x 

Tested on:
The installation was tested on a RedHat 7.2 and SuSe 7.2 with rpm package.
Should work on other systems, too.

Installation steps:
- If you have a rpm-capable system simply run 
  > rpm -i e2920-3.0.0-1.rpm
  this will install all necessary files
- If you have a debian-system please get alien and type:
  > alien -c e2920-3.0.0-1.i386.rpm
  > dpkg -i e2920_%VER-2_i386.deb
- If your system doesn't know how to handle rpms, you have to get the file
  e2920-3.0.0.tar.gz and decompress it with the following command:
  > cd /usr/src; tar xvzf e2920-3.0.0.tar.gz
  Afterwards cd to /usr/src/e2920-3.0.0 and call ./install, so the necessary
  files get installed.

Uninstallation:
- If you have a rpm-capable system simply run 
  > rpm -e e2920


2. Installed files:
-------------------

The installation puts files in the following locations:

/usr/src/e2920-3.0.0:
  Here are the sources and includes for the capi, xcapi and the driver

/usr/share/doc/e2920-3.0.0:
  Here we put this README

/usr/lib/agilent:
  This is the location of the precompiled libraries

/lib/modules/`uname -r`/misc
  This is the location of the PCI driver module (best_pci.o) 
  
/dev/best:
  Here are the files for accessing the driver. 

  Remarks:
  1. Be aware that only root has RW permissions here.
     So if you want to access E2920 cards without root 
     permission (i.e from an ordinary user account), execute: 
     chmod 666 /dev/best/*  
     as root from the commandline.
     This gives RW permissions to all users.
  2. If you are using the devfs (optional available since Kernel 2.4),
     you will have to load the driver manually by executing:
     > modprobe best_pci
     as root from the command line.   


The following files may get touched by the installation:

/etc/ld.so.conf:
  /usr/lib/agilent gets added, if not already listed (for ldconfig)

/etc/modules.conf:
  some entrys for automatic loading of the driver get added

3. Limitations:

Currently only the PCI(X) port working

4. Bugfixes

   Fixed with SW Version 2.7:
   - A bug in the Linux PCI driver sometimes returned wrong values when reading data from card
